browserBeforeNavigateFrame

Type

message

Summary

Sent when a browser is about to navigate to a new url in a frame

Syntax

browserBeforeNavigateFrame <pInstanceId>, <pUrl>

XBrowser_BeforeNavigateFrame <pUrl>, <pInstanceId>

Description

The browserBeforeNavigateFrame message is sent to the current card of a stack containg a browser object when the browser object is about to navigate to a new url in a frame. i.e. a change in the url in the target browser has been requested but not yet actioned.

If the target is the main frame of the browser then the browserBeforeNavigate message is sent instead.

To prevent the navigation occuring, set the global variable browserCancel to true

note

For general information on using the browser library, see the notes in the revBrowserOpen function reference.

Parameters

Name	Type	Description
pInstanceID		The integer identifier of the browser object
pUrl		The new url that is about to be navigated to in the frame

Examples

on browserBeforeNavigateFrame pInstanceId, pUrl
  if not browserFrameNavAllowed() then
    global browserCancel
    put true into browserCancel
  end if
end browserBeforeNavigateFrame

Related

function: revBrowserOpen

glossary: function, browserCancel, message

message: browserBeforeNavigate, browserDownloadRequest, browserNavigateCompleteFrame

Compatibility and Support

Introduced

LiveCode 2.8.1

OS

mac

windows

Platforms

desktop